<html>

<head>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<meta name="GENERATOR" content="Microsoft FrontPage 12.0">
<meta name="ProgId" content="FrontPage.Editor.Document">
<title>Error Reporting</title>
<link href="../book.css" rel="stylesheet" type="text/css">
</head>

<body>

<h1>Error Reporting</h1>
<table border="0" width="860" cellspacing="0" cellpadding="0">
	<tr>
		<td>

When something unexpected happens (such as an exception being thrown) while 
trying to parse a user interface class or perform a design view operation, the 
editor 
will display the following error page:</td>
	</tr>
	<tr>
		<td valign="top">

<table border="0" width="100%" cellspacing="0" cellpadding="0">
	<tr>
		<td valign="top"><br>
<img src="images/error_handling_page.png" border="0" hspace="0"></td>
		<td width="10" valign="top">&nbsp;</td>
		<td valign="top">

<p style='margin-top:12.0pt;text-align:justify;line-height:
14.0pt;mso-pagination:widow-orphan lines-together;tab-stops:0in .5in 1.0in 1.5in 2.0in 2.5in 3.0in 3.5in 4.0in 4.5in 5.0in 5.5in 6.0in right 6.5in'>
The <b><a href="#CreateReportDialog">Create Report</a></b> button opens up 
an error reporting dialog that will create a bug report that you can submit to the 
bug tracking system along with all the needed supporting details.</p>
<p style='margin-top:12.0pt;text-align:center;line-height:
14.0pt;mso-pagination:widow-orphan lines-together;tab-stops:0in .5in 1.0in 1.5in 2.0in 2.5in 3.0in 3.5in 4.0in 4.5in 5.0in 5.5in 6.0in right 6.5in'>
<a href="#CreateReportDialog">
<img src="images/create_report_button.png" border="0" hspace="0" width="133" height="42"></a></p>
<p style='margin-top:12.0pt;text-align:justify;line-height:
14.0pt;mso-pagination:widow-orphan lines-together;tab-stops:0in .5in 1.0in 1.5in 2.0in 2.5in 3.0in 3.5in 4.0in 4.5in 5.0in 5.5in 6.0in right 6.5in'>
The <b>Reparse</b> button will cause the current class to be reparsed.</p>
<p style='margin-top:12.0pt;text-align:center;line-height:
14.0pt;mso-pagination:widow-orphan lines-together;tab-stops:0in .5in 1.0in 1.5in 2.0in 2.5in 3.0in 3.5in 4.0in 4.5in 5.0in 5.5in 6.0in right 6.5in'>
<img src="images/reparse_button.png" border="0" hspace="0"></p>
<p style='margin-top:12.0pt;text-align:justify;line-height:
14.0pt;mso-pagination:widow-orphan lines-together;tab-stops:0in .5in 1.0in 1.5in 2.0in 2.5in 3.0in 3.5in 4.0in 4.5in 5.0in 5.5in 6.0in right 6.5in'>
The <b>Switch to code</b> button will switch the editor back to the <b>Source</b> view.</p>
<p class=MsoNormal style='margin-top:12.0pt;text-align:center;line-height:
14.0pt;mso-pagination:widow-orphan lines-together;tab-stops:0in .5in 1.0in 1.5in 2.0in 2.5in 3.0in 3.5in 4.0in 4.5in 5.0in 5.5in 6.0in right 6.5in'>
<img src="images/switch_to_code_button.png" border="0" hspace="0"></p>

		</td>
	</tr>
</table>
		</td>
	</tr>
	<tr>
		<td>

<p class=MsoNormal style='margin-top:12.0pt;text-align:justify;line-height:
14.0pt;mso-pagination:widow-orphan lines-together;tab-stops:0in .5in 1.0in 1.5in 2.0in 2.5in 3.0in 3.5in 4.0in 4.5in 5.0in 5.5in 6.0in right 6.5in'>
Clicking the <font color="#0000FF"> <b>Show stack trace</b></font> link will reveal the captured stack trace. 
Clicking the link a second time will hide the stack trace.</p>
<p class=MsoNormal style='margin-top:12.0pt;text-align:justify;line-height:
14.0pt;mso-pagination:widow-orphan lines-together;tab-stops:0in .5in 1.0in 1.5in 2.0in 2.5in 3.0in 3.5in 4.0in 4.5in 5.0in 5.5in 6.0in right 6.5in'>
<img src="images/error_handling_page_stack_trace.png" border="0" hspace="0"></p>
<h2 style='margin-top:12.0pt;text-align:justify;line-height:
14.0pt;mso-pagination:widow-orphan lines-together;tab-stops:0in .5in 1.0in 1.5in 2.0in 2.5in 3.0in 3.5in 4.0in 4.5in 5.0in 5.5in 6.0in right 6.5in'>
<a name="CreateReportDialog"></a>Create Report Dialog</h2>
<p class=MsoNormal style='margin-top:12.0pt;text-align:justify;line-height:
14.0pt;mso-pagination:widow-orphan lines-together;tab-stops:0in .5in 1.0in 1.5in 2.0in 2.5in 3.0in 3.5in 4.0in 4.5in 5.0in 5.5in 6.0in right 6.5in'>
Clicking the <b>Create Report</b> button will open the <b>Create Report 
Dialog</b>:</p>

		</td>
	</tr>
	<tr>
		<td>

&nbsp;<table border="0" width="100%" cellspacing="0" cellpadding="0">
	<tr>
		<td valign="top">
		<img src="images/create_report_dialog.png" border="0" hspace="0" width="394" height="243"></td>
		<td width="10" valign="top">&nbsp;</td>
		<td valign="top">The dialog contains several fields for entering 
		information about the problem and several options for attaching 
		important support info:<ul>
			<li>The Eclipse workspace <b>.metadata/.log</b> file is attached. 
			This contains any exceptions triggered as part of the error.</li>
			<li>A <b><a href="#Screenshots">screenshot</a></b> of the design view immediately prior to the 
			exception will be attached. Additional screenshots may be attached.</li>
			<li>The <b>Compilation unit of error</b> (the currently edited 
			class) may be optionally attached (this is recommended).
			<a href="support/test_cases.html">Reproducible test cases</a> are 
			very important for quick problem resolution.</li>
			<li>The <b>Entire project of error</b> (the currently edited 
			project) may be optionally attached (recommended if the current 
			class has a lot of dependencies). <a href="support/test_cases.html">
			Reproducible test cases</a> are very important for quick problem 
			resolution, so including any classes needed to compile the class you 
			are editing can be important.</li>
			<li>A <b><a href="#SoftwareHardwareSummary">Software and hardware 
			summary</a></b> is automatically attached to the case in order to 
			identify any possible conflicts.</li>
			<li>The WindowBuilder <b>preferences</b> are automatically 
			attached to the case.</li>
			<li>Any additional <b><a href="#FileAttachments">File attachments</a></b> 
			may be optionally added to the case (your <b>eclipse.ini</b> file, 
			for example, or any other classes needed by the class you are 
			editing).</li>
		</ul>
		<p>Clicking the <strong>OK</strong> button will generate a ZIP file that 
		should be manually submitted to the <strong>
		<a href="http://eclipse.org/forums/index.php?t=thread&amp;frm_id=214">
		WindowBuilder forum</a></strong> or bug tracking system (<strong><a href="https://bugs.eclipse.org/bugs/">Bugzilla 
		&gt; Tools &gt; WindowBuilder</a></strong>).</p>
		</td>
	</tr>
</table>
<h3><a name="ProductInfo"></a>Screenshots</h3>
<p>Click on the <b>Screenshots <u><font color="#0000FF">add..</font></u></b> 
link to attach additional screenshots to the case.</p>
<p><img src="images/screenshots1.png" border="0" hspace="0">&nbsp;
<img src="images/screenshots2.png" border="0" hspace="0" align="top"></p>
<h3><a name="SoftwareHardwareSummary"></a>Software and hardware summary</h3>
<p>Click on the <b>Software and hardware summary <u><font color="#0000FF">view..</font></u></b> 
link to see the software and hardware info that will be sent along with the case.</p>
<p><img src="images/software_and_hardware_info.png" border="0" hspace="0"></p>
<h3><a name="FileAttachments"></a>File attachments</h3>
<p>Click on the <b>File attachments <u><font color="#0000FF">add..</font></u></b> 
link to attach additional files to the case (such as your <b>eclipse.ini</b> 
file).</p>
<p><img src="images/file_attachments1.png" border="0" hspace="0">&nbsp;
<img src="images/file_attachments2.png" border="0" hspace="0" align="top"></p>
<h2><a name="ContactOptions"></a><br>
<a name="SubmitManually"></a>Manually submit to forum or bug tracking system</h2>
<p>A ZIP file that includes 
all of the case data (including any images and files) is created and should 
be posted to the <strong>
<a href="http://eclipse.org/forums/index.php?t=thread&amp;frm_id=214">
WindowBuilder forum</a></strong> or bug tracking system (<strong><a href="https://bugs.eclipse.org/bugs/">Bugzilla 
&gt; Tools &gt; WindowBuilder</a></strong>).</p>
<p>
<img src="images/submit_manually.png" border="0" hspace="0" align="top"></td>
	</tr>
</table>

</body>

</html>
